Traceability confirmation across models¶
Overview¶
The screen for checking the traceability between models is the Trace Page. The tree-shaped trace page allows you to arrange models with a hierarchical structure and trace them across multiple models for traceability and scope of impact.
In the following, we will explain how to check traceability across models in the following order.
- Switch screen
- Arrange the target models
- Narrow down the traceability confirmation target
- Check traceability across models
- Check the coverage rate of traces for each target model
Switch screen¶
To view the trace page, do the following:
Operating procedure
-
Do one of the following from the ribbon.
- Click Home> View> Trace on the ribbon.
- Click View> Page> Trace on the ribbon.
- Click Traceability> Page> Trace on the ribbon.
-
To return to the editor page where you edit the model, do one of the following:
- Click Home> View> Editor on the ribbon.
- Click View> Page> Editor on the ribbon.
- Click Traceability> Page> Editor on the ribbon.
Arrange the target models¶
To add lanes to the trace page to line up your model of interest, follow these steps:
Operating procedure
- Run the Add Lane command from the menu button at the top right of each lane to see a tree view of the model hierarchy.
- Select a model from the tree and a lane will be added to the right to show the selected model.
Attention
- Even if the model has a derivation-related record, the trace line will not be displayed unless the model displayed in the lane to the right is the derivation-related derivation destination.
To change the model displayed in the lane, do the following:
Operating procedure
- Change the model displayed in the lane by changing the model from the pull-down list at the top of each lane.
To change the order of the lanes, do the following:
Operating procedure
- Execute the [Move Left]/[Move Right] command from the menu button at the top right of each lane to switch the order of the lanes to the left/right.
Narrow down the traceability confirmation target¶
To narrow down the elements to be checked for traceability to the metamodel entities and prevent the elements that do not need to be checked from being displayed on the trace page, follow the procedure below.
Operating procedure
- Return to the editor page and select the model you want to hide on the trace page.
- Click View> Pane> Inspector from the ribbon to display the Inspector.
- Select the Metamodel tab at the top of the Inspector.
- Clear the Show in Trace Page check box in the View group.
- If you switch to the trace page, the elements corresponding to the same entity will disappear from the lane. It is also excluded from the calculation target of coverage rate.
Check traceability across models¶
Follow the procedure below to check traceability and range of influence across the target model starting from any element displayed in the lane.
Operating procedure
- Click an element of the model displayed on the lane to highlight the related element based on the derived relationship and hierarchical structure of that element.
- Expand the tree for each lane as needed to see details for each child element.
The meanings of the icons displayed on the lane are as follows.
Icon position | Meaning |
---|---|
Right edge | Whether or not there is a derivation relationship where the element is the derivation source |
Left end | Presence or absence of derivation related to which the element is the derivation destination |
Icon type | Meaning |
---|---|
One or more derived relationships | |
No derivation related | |
Excluded from calculation of trace coverage | |
No icon | The element itself does not have a derivation association, but owns a descendant that has a derivation association |
Trace lines are displayed between lanes when there is a derived relationship between elements on adjacent lanes. The types of trace lines displayed are as follows.
Linetype | Meaning |
---|---|
Solid | Trace lines between elements that are displayed as tree expansions in adjacent lanes |
Dash Line | Trace line between elements where the tree is collapsed and hidden in one of the adjacent lanes |
Note
- To display only the trace lines between the elements represented by the solid line without displaying the trace lines between the child elements represented by the dotted line, select [Traceability]> [Traceability]> [Show Trace] from the ribbon. Select Show Direct Trace Only.
- To display both dotted and solid lines, select Traceability> Traceability> Show Trace> Show Direct and Indirect Trace from the ribbon.
Check the coverage rate of traces for each target model¶
Check the coverage ratio of the trace information between the derivation source (left) and the derivation destination (right) using the percentages displayed at the bottom of each lane.
Calculation method of trace coverage
-
The coverage rate is calculated by the following formula for each trace direction (derivative source/derivation destination) in each lane.
Coverage = Number of elements that have one or more derived associations/Number of elements that can have derived associations
-
If the element itself does not have a derivation association but its descendants have a derivation association, it will appear as a parent element in the lane tree, but will not be included in the denominator of the formula.
- Percentages after the decimal point are rounded up. However, if it is 99% or more and less than 100%, it will be rounded down to 99%. *Always calculated based on 150% model, regardless of product application status.
Hint
- To check the trace coverage when the product is applied, export the project after applying the product and display the trace page. Please refer to Modeling Guide> Product Line Development> Export Product Application Design Model for the export method.
restrictions
- If an element can have multiple types of derivation associations in the same trace direction, and if there is one or more derivation associations of any one type, that element is calculated as having derivation associations.
- For example, if the elements of the requirement model can have two types, a derivation relationship with the elements of the logical design model and a derivation relationship with the elements of the physical configuration model, if there is one or more derivation relationships of the former, the derivation of the latter Even if it is not related, it is calculated as derived related.
To specify a specific element to be excluded from the calculation of trace coverage, follow the procedure below.
Operating procedure
- Right-click the element you want to exclude from the trace coverage calculation on the lane to open the context menu.
- From the context menu, run Exclude traceability coverage from calculation to open the Exclusion setting of Traceability Coverage dialog.
- From the Trace Direction choices, select the direction you want to exclude from the calculation.
- Enter the reason in the Reasons for excluding the calculation of trace coverage text box and click the [OK] button.
- The icon on the side selected in [Trace Direction] changes to an icon indicating that the trace coverage is not calculated.
- Click Traceability> Traceability Coverage> Show Models Excluded from Calculation from the ribbon to list the elements that are not included in the calculation and why.
Note
- To specify the metamodel entities and exclude the relevant elements from the calculation of trace coverage rate at once, refer to "Narrowing down the target of traceability check" above.